Duty Tax Calculator API
API Usage
Resource Information:
| Endpoint Name | Function | Resource URL | Verb |
|---|---|---|---|
| LandedCost | Returns a detailed breakdown of all applicable duties, taxes, and fees for an international shipment based on shipment's origin, destination, and item details. | UAT: https://api.uat.nzpost.co.nz/duty-tax-calculator/v1/landedcost PROD: https://api.nzpost.co.nz/duty-tax-calculator/v1/landedcost | POST |
Sample Request
{
"currency": "NZD",
"ship_from": {
"country": "NZ"
},
"ship_to": {
"country": "US",
"state": "SP",
"city": "Campinas",
"postal_code": "75828-000"
},
"items": [
{
"amount": 75,
"currency": "NZD",
"country_of_origin": "FR",
"description_customs": "Hoka One Running Shoe - Women's",
"hs_code": "6116.10.00",
"quantity": 1,
"weight": 3.24
},
{
"amount": 15,
"currency": "EUR",
"country_of_origin": "CN",
"description_customs": "Men's t-shirt 100% polyester",
"quantity": 2
}
],
"calculation_method": "DAP",
"end_use": "NOT_FOR_RESALE"
}Sample Response
{
"success": true,
"message_id": "4e2a0670-8481-11f0-b7fb-0243f35065bb",
"shipment_summary": {
"total_duties": 52.6529,
"total_taxes": 0.00,
"total_fees": 4.45,
"currency": "NZD"
},
"item_calculations": [
{
"index": 0,
"hs_code": "6116.10.6500",
"total_duties": 11.25,
"total_taxes": 0.00,
"duties": [
{
"amount": 5.25,
"formula": "7 % cost",
"note": "General Rate",
"type": "ITEM"
},
{
"amount": 6.00,
"formula": "8.000000 % cost",
"note": "variable additional duty to comply to new regulation",
"type": "ITEM"
}
],
"taxes": []
},
{
"index": 1,
"hs_code": "6109.90.1007",
"total_duties": 41.4029,
"total_taxes": 0.00,
"duties": [
{
"amount": 19.0633,
"formula": "32 % cost",
"note": "General Rate",
"type": "ITEM"
},
{
"amount": 11.9144,
"formula": "20 % cost",
"note": "Feb 25 US<CN Tariffs",
"type": "ITEM"
},
{
"amount": 5.9573,
"formula": "10 % cost",
"note": "Reduced Apr US<CN Additional Duty",
"type": "ITEM"
},
{
"amount": 4.4679,
"formula": "7.5 % cost",
"note": "2018 Section 301 Tariffs",
"type": "ITEM"
}
],
"taxes": []
}
],
"shipment_fees": [
{
"amount": 4.45,
"formula": "$2.62 USD",
"note": null,
"type": "COUNTRY"
}
]
}